home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Turnbull China Bikeride
/
Turnbull China Bikeride - Disc 1.iso
/
ARMCLUB
/
EUREKA
/
EUREKA24
/
ArcWeb192
/
Instruct
< prev
next >
Wrap
Text File
|
1997-08-12
|
9KB
|
235 lines
ArcWeb Instructions
===================
Contents
========
Introduction
Before running for the first time
Patching ChangeFSI
How to install the DNS configuration files
How to run it
How to cure the 'Too Long' errors
How to configure ArcWeb for mail and news
How to change the default page
How to change the location of the disk cache
How to remove everything from the cache
How to control the authentication database
Running with RISC OS 3.60 and later (inlining JPEGs)
Introduction
============
I realise that it may seem that you have to read a lot of instructions
before you can do anything, but I've tried to spell it all out in as
much detail as possible in an attempt to pre-empt the common problems
which people have had in the past. I get so many e-mails about the
"Too Long" problem, still.
This file gives some instruction on how to get ArcWeb up and running at least
on a local basis. Once this has been achieved, there are help files supplied
in HTML format. Run !ArcWeb and click SELECT over the icon bar icon to open
the index page, and then you can follow links to information about the helper
applications and their configuration. I suggest you read the instructions
for network configuration very carefully. There are instructions further
down for upgrading your current ArcWeb to this version.
If you get stuck, try the Problems file. This is a FAQ style document
containing around 20 common questions and answers.
Before running for the first time
=================================
ArcWeb cannot do everything itself. It needs 'helper' applications. These
are stored inside the !WebHelper application. KA9Q users need to read the
section immediately below. FreeNet/Acorn users can skip to the next
non-indented paragraph.
KA9Q users only
---------------
This version of ArcWeb is unlikely to work with KA9Q. I suggest
that you investigate FreeNet or Acorn TCP/IP release 4.
Copy any auxiliary applications you have into !WebHelper application. To do
this, double-click on !WebHelper and the subdirectory will be displayed.
!FilerURLs is already installed in this directory. You must configure your
e-mail address and on-line news server name (if you have one). See
'Configuration' below.
You may choose to install things like SoundCon inside !WebHelper so that
they automatically load when ArcWeb does.
Patching ChangeFSI
==================
Read the instructions in the file "ReadMeDocs.JPEG_Fix" for instructions
on modifications that should be made to ChangeFSI in order to enable it
to support more types of JPEG image.
How to install the DNS configuration files
==========================================
If you are not already running a FreeNet configuration or using
InetDB or DNSResolver, you will need to install the DNS configuration
files in your InetDBase$Path directory. You do not actually need
the DNS module running, as ArcWeb contains a DNS resolver anyway.
If you are using ANT !InetSuite, then you need not worry about this
section - ArcWeb will use the !InetSuite configuration directly.
The Name Lookup service is responsible for asking other machines
(nameservers) to convert hostnames which the user sees (like
delenn.ecs.soton.ac.uk) into IP addresses (like 152.78.67.42) which it needs
in order to be able to connect to a given machine.
You need to ensure that the configuration files are already present in
the files database (InetDbase$Path - typically !Internet.files or
!FreeUser.files)
Read InetDB.ReadMe1st for more information on configuring the files.
To run it
=========
Launch !ArcWeb by double-click on !ArcWeb in directory viewer, or
double-clicking on HTML files. Click icon bar icon to bring up 'home' page.
All applications inside !WebHelper will be loaded automatically.
Rather than babble on at great length on what each menu entry does, I
recommend loading the Acorn !Help application and then an exploring of the
menus. !ArcWeb supports full interactive help on all windows, dialogue boxes
and menus.
Basically: To follow a link, click SELECT over it; to open a new page choose
Open URL from the Navigate menu over a document (or from the icon bar menu).
Alternatively, to go to a specific URL you can enter it in the icon at the
top of an open ArcWeb page.
If you get 'Too Long' errors
============================
Quit !ArcWeb. Move !WebCache closer to the root directory of the device on
which they are stored, and then 'run' it by double-clicking on its icon.
See Problems Q18 for more details of why you must do this.
Configuration
=============
You MUST reconfigure the e-mail address and the news server address. Click
MENU over ArcWeb's icon bar icon and choose "EMail & News" from the
"Configuration" menu to open the configuration window. You may wish to set
up proxy servers for HTTP, FTP, gopher and WAIS in the Network window.
ArcWeb will handle FTP and HTTP and gopher itself if you want it to.
More help is available by clicking SELECT over the Information icon (the same
as !Help's icon) at the top of the Network window.
How to change the default page
==============================
The 'home page' is controlled by an environment variable ArcWeb$Home. If
this variable is not set when ArcWeb is run, it will set it to a default
document within an ArcWeb subdirectory.
How to change the cache location
================================
The 'cache directory' is controlled by environment variable Arcweb$CacheDir
If this variable is not set when ArcWeb is run, it will set it to a default
directory within an ArcWeb subdirectory. The !WebCache application supplied
contains a !Boot file which initialises this variable to a subdirectory of
itself. This allows !ArcWeb to be stored in a read only filing system.
Don't put extra files in the cache directories. The cache manager will find
these and remove them. By default it allows 75 files to be cached (no size
limit) so it doesn't want other things clogging up the directory. The cache
manager will remove anything not in the index, and remove anything from the
index which doesn't exist in the sources directory. IF the Cache Manager
cannot remove a file (because it is open for example), it will leave it
there.
How to remove everything from the cache
=======================================
Open the Cache configuration window and click on the 'Flush images' or 'Flush
everything' menu items. You will be prompted to confirm the action.
Every so often, the cache is checked for documents which have passed their
expiry date. These old documents are removed (unless they are currently
being fetched, or are currently being viewed, or if it is inlined image
which is part of a currently being fetched/viewed document.). This facility
can be disabled in the Cache configuration window. The frequency of the
checking can also been configured from there.
How to control the authentication database
==========================================
The 'authentication database' holds a cache of servers and their realms which
have required authentication in the current session. By default, it is wiped
when ArcWeb exits (but can be reconfigured in the Network configuration
window) as a security precaution. Its location is controlled by
ArcWeb$AuthFile which is set by !WebCache or !ArcWeb when it is run and
!WebCache hasn't set it yet.
Running with RISC OS 3.60 and later (inlining JPEGs)
====================================================
ArcWeb 0.37 and later contain support for inlined JPEGs - a facility
built into the RISC OS ROMs in RISC OS 3.60 and later. Since I do
not have a Risc PC700 to test with, this feature is not enabled by
default as I have no way of testing it personally. To the best of
my knowledge it will work though.
To enable the JPEG option, enable the option in the Browser configuration
window. If the option has been used, ArcWeb will verify that you have
SpriteExtend 0.80 or later before attempting anything clever. (In fact
it makes it unselectable if you don't have a suitable module).
It appears that Draw has a problem with the draw files that I export with
contain JPEGs though. I'm not sure why this is at the moment and it is still
under investigation.
Configuration of ArcWeb
=======================
All the configuration windows are available on the Configure submenu
of the icon bar menu, and from the Options menu on the page menu.
See the Problems file for more on how to reconfigure these programs.
Comments and bug reports via e-mail as below, please.
Thanks for your help,
Stewart
--
Contact Addresses
=================
15 Dowding Road
Biggin Hill
Kent
TN16 3BE
E-mail: S.N.Brodie@ecs.soton.ac.uk
WWW : http://www.dsse.ecs.soton.ac.uk/~snb94r/
WWW : http://delenn.ecs.soton.ac.uk/
gopher: gopher://delenn.ecs.soton.ac.uk/
finger: finger://delenn.ecs.soton.ac.uk/stewart